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struct uno Environment 

{ " P-4355 

/** a name for this environment 
*/ 

rtl_String * pName; 

/** A free context pointer, that can be used for specific classes of environments, e.g. 
a jvm pointer 

*/ 

void * pContext; 
/** Acquires this environment. 

@param pEnv this interface 

*/ 

void (SAL_CALL * acquire)( uno_Environment * pEnv ); 
/** Releases this environment; Last release of environment revokes the environment 
from runtime. 

@param pAccess this access interface 

*/ 

void (SALCALL * release)( uno_Environment * pEnv ); 
/** Tests if two environments are equal. 

@param pEnvl one environment 
@param pEnv2 another environment 

*/ 

sal Bool (SAL_CALL * equals) ( const unoEnvironment* pEnvl, const 
unoEnvironment * pEnv2 ); 

/** 

* You register internal and external interfaces via his method. Internal interfaces are 
proxies that are used in an environment. External interfaces are interfaces 
that are exported to another environment, thus providing an object identifier 
for this task. This can be called an external reference. Interfaces are held 
weakly at an environment; they demand a final revokeInterface()call for each 
interface that has been registered. 

@param pEnv this environment 

@param pplnterface inout parameter for the registered interface 
@param ppOId inout parameter for the corresponding object id 
@param pTypeDescr type description of interface 
@param acquire function to acquire an interface; this function 

provides a boolean return value to signal if the acquisition was 
successful (necessary for proxy interfaces) 



■7 



void (SAL CALL * registerlnterface) (uno Environment * pEnv, void ** 
pplnterface, rtl String ** ppOId, typelib_InterfaceTypeDescription 
*pTypeDescr, uno_regAcquireFunc acquire ); 

ANY interface that has been registered is revokeed via this method. 
@param pEnv this environment 
@param pOId object id of interface to be revoked 
@param pTypeDescr type description of interface to be revoked 

void (SAL CALL * revokelnterface) ( uno Environment * pEnv, rtl String * 
pOId, typelib_InterfaceTypeDescription * pTypeDescr ); 



Fig. 3A 
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/** Retrieves an interface identified by its object id and type from this environment. 
@param pEnv this environment 

@param.pp Interface inout parameter for the registered interface; (0) if 

none was found 
@param pOId object id of interface to be retrieved 
@param pTypeDescr type description of interface to be retrieved 

*/ 

void (SAL_CALL * getRegisteredlnterface) ( uno_Environment * pEnv, void 
** pplnterface, rtl_String * pOId, typelib lnterfaceTypeDescription * 
pTypeDescr ); 

Retrieves the object identifier for a registered interface from this environment. 
@param pEnv this environment 

@param ppOId inout parameter for object id of interface; (0) if none 

was found 
@param plnterface a registered interface 
@param pTypeDescr type description of interface 

*/ 

void (SAL_CALL * getRegisteredObjectldentifier) ( uno_Environment * 
pEnv, rtl_String ** ppOId, void * 

pInterface,typelib_InterfaceTypeDescription * pTypeDescr ); 

/** 

* Disposing callback function pointer that can be set to get signalled before the 

environment is destroyed. 

@param pEnv environment that is being disposed 

*/ 

void (SAL CALL * environmentDisposing) ( uno_Environment * pEnv ); 

*/** 

* Computes an object identifier for the given interface; is called by the environment 

implementation. 

@param pEnv corresponding environment 
@param ppOId out param: computed id 
@param plnterface an interface 

*/ 

void (SAL_CALL * computeObjectldentifier) ( uno_Environment * pEnv, 
rtl_String ** ppOId, void * plnterface ); 
/** Function to acquire an interface. 

@param pEnv corresponding environment 
@param plnterface an interface 

*/ 

void (SAL CALL * acquirelnterface) ( uno_Environment * pEnv, void * 
plnterface ); 

/** 

* Function to release an interface. 

@param pEnv corresponding environment 
@param plnterface an interface 

*/ 

void (SAL_CALL * releaselnterface) ( uno_Environment * pEnv, void * plnterface 

); 

}; 

Fig. 3B 
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